The Handblade Observer script is a script that can be added onto GameObjects that you would like to detect when a handblade is present within the area of the GameObject.

The HandbladeObserver script requires the Gameboard GameObject to be present. Find the Gameboard menu at the top of the unity header and click "Add SDK" to add the Gameboard GameObject to your project. If you do not have the Gameboard menu options, see Gameboard SDK Access

First, select all the GameObjects you would like to know when a handblade is present within it's bounds.

Next, find the Gameboard menu at the top of the unity header and click "Add Handblade Observer" to add the HandbladeObserver to your GameObject(s).

This will add a the script to the gameobjects, and you will see a red gizmo indicating the area where the handblade will be detected.

Now that GameObject is able to quickly notify when a handblade is within an area!

You will notice the Handblade Observer Script has a few customizable options.

Property Descriptions

• Id: Optional id to help identify the specific handblade observer in code
• World View Camera: If your handblade observer is not placed within a canvas, you must supply the camera that corresponds with the physical gameboard screen. Uses Camera.main if nothing is specified.
• Gizmo Color: Color of gizmo that shows to help debug area the handblade will trigger within.

There are various events that you can use to keep track of physical token pairing and paired token locations:

OnHandbladeFound

Properties: GameboardShape shape

• This event triggers when a handblade is found within the area of the GameObject.

OnHandbladeUpdated

Properties: GameboardShape shape, bool withinArea

• This is triggered if any handblades that were found within the area of the GameObject are updated. It returns the GameboardShape object of that handblade, and also a boolean as to if that handblade is still within the area of the GameObject.

OnHandbladeLost

Properties: GameboardShape piece

• This is called when the handblades that were found within the area are removed from the board.

NOTE The GameboardShape used to represent the Handblade will include an angle property, and that angle indicates the ‘forward' angle in radians. The ‘forward' for a handblade is pointing towards what is considered inside the hand.